/*********************************************************************************************************************
* TC387 Opensourec Library 即（TC387 开源库）是一个基于官方 SDK 接口的第三方开源库
* Copyright (c) 2022 SEEKFREE 逐飞科技
*
* 本文件是 TC387 开源库的一部分
*
* TC387 开源库 是免费软件
* 您可以根据自由软件基金会发布的 GPL（GNU General Public License，即 GNU通用公共许可证）的条款
* 即 GPL 的第3版（即 GPL3.0）或（您选择的）任何后来的版本，重新发布和/或修改它
*
* 本开源库的发布是希望它能发挥作用，但并未对其作任何的保证
* 甚至没有隐含的适销性或适合特定用途的保证
* 更多细节请参见 GPL
*
* 您应该在收到本开源库的同时收到一份 GPL 的副本
* 如果没有，请参阅<https://www.gnu.org/licenses/>
*
* 额外注明：
* 本开源库使用 GPL3.0 开源许可证协议 以上许可申明为译文版本
* 许可申明英文版在 libraries/doc 文件夹下的 GPL3_permission_statement.txt 文件中
* 许可证副本在 libraries 文件夹下 即该文件夹下的 LICENSE 文件
* 欢迎各位使用并传播本程序 但修改内容时必须保留逐飞科技的版权声明（即本声明）
*
* 文件名称          zf_device_tft180
* 公司名称          成都逐飞科技有限公司
* 版本信息          查看 libraries/doc 文件夹内 version 文件 版本说明
* 开发环境          ADS v1.10.2
* 适用平台          TC387QP
* 店铺链接          https://seekfree.taobao.com/
*
* 修改记录
* 日期              作者                备注
* 2022-11-04       pudding            first version
* 2023-04-28       pudding            增加中文注释说明
********************************************************************************************************************/
/*********************************************************************************************************************
* 接线定义：
*                  ------------------------------------
*                  模块管脚              单片机管脚
*                  SCL                 查看 zf_device_tft180.h 中 TFT180_SCL_PIN 宏定义
*                  SDA                 查看 zf_device_tft180.h 中 TFT180_SDA_PIN 宏定义
*                  RES                 查看 zf_device_tft180.h 中 TFT180_RES_PIN 宏定义
*                  DC                  查看 zf_device_tft180.h 中 TFT180_DC_PIN 宏定义
*                  CS                  查看 zf_device_tft180.h 中 TFT180_CS_PIN 宏定义
*                  BL                  查看 zf_device_tft180.h 中 TFT180_BL_PIN 宏定义
*                  VCC                 3.3V电源
*                  GND                 电源地
*                  最大分辨率160*128
*                  ------------------------------------
********************************************************************************************************************/

#ifndef _zf_device_tft180_h_
#define _zf_device_tft180_h_

#include "zf_common_typedef.h"

//=================================================定义 TFT180 基本配置================================================
#define TFT180_USE_SOFT_SPI             (0)                                     // 默认使用硬件 SPI 方式驱动 建议使用硬件 SPI 方式驱动
#if TFT180_USE_SOFT_SPI                                                         // 这两段 颜色正常的才是正确的 颜色灰的就是没有用的
//====================================================软件 SPI 驱动====================================================
#define TFT180_SOFT_SPI_DELAY           (0 )                                    // 软件 SPI 的时钟延时周期 数值越小 SPI 通信速率越快
#define TFT180_SCL_PIN                  (P15_3)                                 // 软件 SPI SCK 引脚
#define TFT180_SDA_PIN                  (P15_5)                                 // 软件 SPI MOSI 引脚
//====================================================软件 SPI 驱动====================================================
#else
//====================================================硬件 SPI 驱动====================================================
#define TFT180_SPI_SPEED                (60*1000*1000)                          // 硬件 SPI 速率
#define TFT180_SPI                      (SPI_2)                                 // 硬件 SPI 号
#define TFT180_SCL_PIN                  (SPI2_SCLK_P15_3)                       // 硬件 SPI SCK 引脚
#define TFT180_SDA_PIN                  (SPI2_MOSI_P15_5)                       // 硬件 SPI MOSI 引脚
#define TFT180_SDA_PIN_IN               (SPI2_MISO_P15_4)                       // 硬件 SPI MISO 引脚  TFT没有MISO引脚，但是这里任然需要定义，在spi的初始化时需要使用
//====================================================硬件 SPI 驱动====================================================
#endif

#define TFT180_RES_PIN                  (P15_1)                                 // 液晶复位引脚定义
#define TFT180_DC_PIN                   (P15_0)                                 // 液晶命令位引脚定义
#define TFT180_CS_PIN                   (P15_2)                                 // CS 片选引脚
#define TFT180_BL_PIN                   (P15_4)                                 // 液晶背光引脚定义

#define TFT180_DEFAULT_DISPLAY_DIR      (TFT180_CROSSWISE)                        // 默认的显示方向
#define TFT180_DEFAULT_PENCOLOR         (RGB565_RED)                            // 默认的画笔颜色
#define TFT180_DEFAULT_BGCOLOR          (RGB565_WHITE)                          // 默认的背景颜色
#define TFT180_DEFAULT_DISPLAY_FONT     (TFT180_8X16_FONT)                      // 默认的字体模式

#define TFT180_DC(x)                    ((x) ? (gpio_high(TFT180_DC_PIN))  : (gpio_low(TFT180_DC_PIN)))
#define TFT180_RST(x)                   ((x) ? (gpio_high(TFT180_RES_PIN)) : (gpio_low(TFT180_RES_PIN)))
#define TFT180_CS(x)                    ((x) ? (gpio_high(TFT180_CS_PIN))  : (gpio_low(TFT180_CS_PIN)))
#define TFT180_BLK(x)                   ((x) ? (gpio_high(TFT180_BL_PIN))  : (gpio_low(TFT180_BL_PIN)))
//=================================================定义 TFT180 基本配置================================================


//=================================================定义 TFT180 参数结构体===============================================
typedef enum
{
    TFT180_PORTAIT                      = 0,                                    // 竖屏模式
    TFT180_PORTAIT_180                  = 1,                                    // 竖屏模式  旋转180
    TFT180_CROSSWISE                    = 2,                                    // 横屏模式
    TFT180_CROSSWISE_180                = 3,                                    // 横屏模式  旋转180
}tft180_dir_enum;

typedef enum
{
    TFT180_6X8_FONT                     = 0,                                    // 6x8      字体
    TFT180_8X16_FONT                    = 1,                                    // 8x16     字体
    TFT180_16X16_FONT                   = 2,                                    // 16x16    字体 目前不支持
}tft180_font_size_enum;

extern  uint16  tft180_width_max ;
extern  uint16  tft180_height_max;
//=================================================定义 TFT180 参数结构体===============================================


//=================================================声明 TFT180 基础函数================================================
void    tft180_clear                    (void);                                                                               // TFT180 清屏函数
void    tft180_full                     (const uint16 color);                                                                 // TFT180 屏幕填充函数
void    tft180_set_dir                  (tft180_dir_enum dir);                                                                // TFT180 设置显示方向
void    tft180_set_font                 (tft180_font_size_enum font);                                                         // TFT180 设置显示字体
void    tft180_set_color                (const uint16 pen, const  uint16 bgcolor);                                            // TFT180 设置显示颜色
void    tft180_draw_point               (uint16 x, uint16 y, const uint16 color);                                             // TFT180 画点函数
void    tft180_draw_line                (uint16 x_start, uint16 y_start, uint16 x_end, uint16 y_end, const uint16 color);     // TFT180 画线函数

void    tft180_show_char                (uint16 x, uint16 y, const char dat);                                                 // TFT180 显示字符
void    tft180_show_string              (uint16 x, uint16 y, const char dat[]);                                               // TFT180 显示字符串
void    tft180_show_int                 (uint16 x,uint16 y, const int32 dat, uint8 num);                                      // TFT180 显示32位有符号 (去除整数部分无效的0)
void    tft180_show_uint                (uint16 x,uint16 y, const uint32 dat, uint8 num);                                     // TFT180 显示32位无符号 (去除整数部分无效的0)
void    tft180_show_float               (uint16 x, uint16 y, const double dat, uint8 num, uint8 pointnum);

void    tft180_show_binary_image        (uint16 x, uint16 y, const uint8 *image, uint16 width, uint16 height, uint16 dis_width, uint16 dis_height);                    // TFT180 显示二值图像 数据每八个点组成一个字节数据
void    tft180_show_gray_image          (uint16 x, uint16 y, const uint8 *image, uint16 width, uint16 height, uint16 dis_width, uint16 dis_height, uint8 threshold);   // TFT180 显示 8bit 灰度图像 带二值化阈值
void    tft180_show_rgb565_image        (uint16 x, uint16 y, const uint16 *image, uint16 width, uint16 height, uint16 dis_width, uint16 dis_height, uint8 color_mode); // TFT180 显示 RGB565 彩色图像

void    tft180_show_wave                (uint16 x, uint16 y, const uint16 *wave, uint16 width, uint16 value_max, uint16 dis_width, uint16 dis_value_max);              // TFT180 显示波形
void    tft180_show_chinese             (uint16 x, uint16 y, uint8 size, const uint8 *chinese_buffer, uint8 number, const uint16 color);                               // TFT180 汉字显示
                                                                                                                              // 1.8寸TFT屏幕初始化
void    tft180_init                     (void);
//=================================================声明 TFT180 基础函数================================================


//=================================================声明 TFT180 扩展函数================================================
//-------------------------------------------------------------------------------------------------------------------
// 函数简介     TFT180 显示小钻风图像
// 参数说明     p               图像数组指针
// 参数说明     width           图像实际宽度
// 参数说明     height          图像实际高度
// 返回参数     void
// 使用示例     tft180_displayimage7725(ov7725_image_binary[0], OV7725_W, OV7725_H);
// 备注信息     拓展的一键显示函数，默认无缩放，从屏幕坐标起始点开始显示
//-------------------------------------------------------------------------------------------------------------------
#define tft180_displayimage7725(p, width, height)       (tft180_show_binary_image(0, 0, (p), OV7725_W, OV7725_H, (width), (height)))
//-------------------------------------------------------------------------------------------------------------------
// 函数简介     TFT180 显示总钻风图像
// 参数说明     p               图像数组指针
// 参数说明     width           图像实际宽度
// 参数说明     height          图像实际高度
// 返回参数     void
// 使用示例     tft180_displayimage03x(mt9v03x_image[0], MT9V03X_W, MT9V03X_H);
// 备注信息     拓展的一键显示函数，默认无缩放，从屏幕坐标起始点开始显示
//-------------------------------------------------------------------------------------------------------------------
#define tft180_displayimage03x(p, width, height)        (tft180_show_gray_image(0, 0, (p), MT9V03X_W, MT9V03X_H, (width), (height), 0))
//-------------------------------------------------------------------------------------------------------------------
// 函数简介     TFT180 显示凌瞳图像
// 参数说明     p               图像数组指针
// 参数说明     width           图像实际宽度
// 参数说明     height          图像实际高度
// 返回参数     void
// 使用示例     tft180_displayimage8660(scc8660_image[0], SCC8660_W, SCC8660_H);
// 备注信息     拓展的一键显示函数，默认无缩放，从屏幕坐标起始点开始显示
//-------------------------------------------------------------------------------------------------------------------
#define tft180_displayimage8660(p, width, height)       (tft180_show_rgb565_image(0, 0, (p), SCC8660_W, SCC8660_H, (width), (height), 1))
//=================================================声明 TFT180 扩展函数================================================


#endif
